home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Tele / Internet / UUPC 3.1b25 Folder / Documentation / UUPC & the Comm Toolbox < prev    next >
Encoding:
Text File  |  1992-08-04  |  11.4 KB  |  247 lines  |  [TEXT/ALFA]
  1.                        D R A F T               7/8/92
  2.  
  3. UUPC and the Communications Toolbox
  4. -----------------------------------
  5.  
  6. Starting with version 3.1b6, uupc supports the Macintosh Communications
  7. Toolbox.  That is to say, uupc can use the Connection Manager, and any
  8. available connection tool, in place of the Serial Driver (the Serial Driver
  9. interface still works, naturally!).
  10.  
  11. Support in 3.1b9 handles both inbound and outbound calls. Performance
  12. should be comparable to the Serial Driver implementation. There are
  13. probably still bugs which may cause irregular behavior or crashes.
  14.  
  15. Basic philosophy
  16. ----------------
  17.  
  18. When you use the Serial Drivers, you can use either of two methods to cause
  19. your modem to place a phone call to your neighbor site.  These methods are
  20. selected via options in the site's line in your Systems file.
  21.  
  22. * You can specify one of uupc's built-in dialers (either HAYES or VADIC),
  23. specify the baud rate and phone number, and let the uupc dialer talk to
  24. the modem, autobaud it, dial, and interpret the CONNECT or BUSY messages.
  25.  
  26. * You can specify the DIR (direct-connection) "dialer", which simply
  27. opens the serial port connection;  your chat script (the expect/send
  28. strings) must send commands to the modem and wait for the modem's responses.
  29.  
  30. When you use the Communications Toolbox, you have both of these options,
  31. and even more.  You can use the dialing or call-connection facilities
  32. in a CTB connection tool;  you can use a CTB tool to give you access to a
  33. modem or serial port on your Mac, and use uupc's HAYES dialer to place the
  34. call;  or, you can use a CTB tool to access a serial port, and drive the
  35. modem yourself via a chat script.
  36.  
  37. Setting up a Communications Toolbox configuration
  38. -------------------------------------------------
  39.  
  40. Access to the Communications Toolbox takes place through connection
  41. records, which you must configure using menus and dialogs.
  42.  
  43. To create a new connection record, select "New..." from the "CTB" menu.
  44. A dialog box will pop up, selecting a default connection tool (usually
  45. the Apple Serial Tool).  Choose the tool that you really wish to use...
  46. e.g. the Apple Modem Tool, Apple ADSP Tool, or some other tool... and
  47. configure it with whatever information, options, phone numbers, network
  48. addresses, etc. are relevant.  Click the OK button.  You'll be asked to
  49. enter the name under which this configuration should be stored... do so
  50. (names which do not contain blanks are preferred).
  51.  
  52. To alter an existing configuration, choose its name from the CTB menu,
  53. edit the configuration, and click OK.  The configuration will be updated
  54. and stored.
  55.  
  56. To duplicate an existing configuration, hold down the shift key and
  57. select its name from the CTB menu.  The configuration will be "cloned" and then its
  58. dialog box will appear.  Make any changes you want (which will apply to the
  59. new version, not the original!) and click OK.  You'll be prompted for
  60. the name under which the new configuration should be stored.
  61.  
  62. To delete an existing configuration, hold down the option key and select
  63. its name from the CTB menu.  A confirmation dialog box will appear;
  64. click Delete or Cancel as appropriate.
  65.  
  66. Using Communications Toolbox configurations
  67. -------------------------------------------
  68.  
  69. In order to use a connection tool to place a call to one of your uucp
  70. neighbors, you must modify the neighbor's line in your Systems file. In the
  71. field which normally specifies a serial-port name (usually "a" or "b),
  72. place a string of the form "CTB/configurationname". The "configurationname"
  73. should be the name of a CTB configuration that you have created and saved.
  74. When you place a call using the information in this line in the Systems
  75. file, uupc will bypass the Serial Driver, load the CTB configuration you
  76. specified, and use it to initiate a connection
  77.  
  78. Accessing auxiliary serial ports
  79. --------------------------------
  80.  
  81. The simplest way to use a CTB tool is to use it to give you access to 
  82. a serial port on your Mac.  This is usually done with the Apple Serial
  83. Tool.  Using this tool, you may specify the modem port, printer port, or
  84. any auxiliary port which has been registered with the Connection Manager.
  85.  
  86. For a connection of this sort, you will usually specify the HAYES dialer,
  87. and allow uupc to dial the call for you.  You may, if you wish, specify
  88. the DIR non-dialer, and place the call "manually" using the chat
  89. script.
  90.  
  91. Using a Modem Tool (Apple's or otherwise)
  92. -----------------------------------------
  93.  
  94. You may wish to use the Apple Modem Tool to establish a connection with one
  95. or more of your neighbors. The Apple Modem Tool supports a number of
  96. popular modem types, and supplies certain features that uupc's built-in
  97. HAYES dialer does not (automatic redial, RTS/CTS flow control, "soft"
  98. hangup using the Hayes +++ escape sequence, etc.). To do this, you must
  99. create a CTB configuration which selects the Apple Modem Tool, and
  100. specifies whatever options you feel are appropriate.
  101.  
  102. When you use a Modem Tool to place a call, you will NOT be using the
  103. HAYES dialer which is built into uupc.  For this reason, you MUST specify
  104. the "DIR" (direct connection) non-dialer whenever you use a Modem Tool to
  105. place a call.  Otherwise, massive confusion will result!
  106.  
  107. You may, if you wish, store the phone number in the CTB configuration, and
  108. omit the phone number from the line in your Systems file (simply put a
  109. hyphen in the phone number field).  You'll probably want to use this
  110. approach if you have only a single uucp neighbor, or if you decide that
  111. you'd rather have one CTB configuration per neighbor.
  112.  
  113. Or, you may leave the phone number out of the CTB configuration, and
  114. specify it in the Systems file (just as you normally do when using the
  115. built-in Hayes dialer). If the phone number is present in the Systems file,
  116. it will override the number stored in the CTB configuration record. This
  117. allows you to use one CTB configuration to place calls to two or more
  118. neighbors.
  119.  
  120. Similarly, you may specify the baud rate in either of two places - in the
  121. CTB configuration record, or in the Systems file.  If a baud rate is
  122. present in the Systems file, it will override the baud rate in the
  123. configuration record;  if the baud-rate field in the Systems file simply
  124. contains a hyphen, it is ignored, and the baud-rate field in the
  125. configuration record is used.
  126.  
  127. Using other connection tools
  128. ----------------------------
  129.  
  130. You can use other sorts of connection tools... for example, the Apple
  131. ADSP Tool... in much the same way as you would use a Modem Tool.
  132. Fill out the connection information completely, store it, name it in the
  133. CTB/port field in the Systems file entry, and use the DIR direct-connection
  134. non-dialer.
  135.  
  136. You may pass options to a connection tool, by placing them in either the
  137. baud-rate or phone-number fields in the Systems file.  Options are specified
  138. as a single string of the form:
  139.  
  140.     'name value name value'
  141.  
  142. where the names and values of the options are defined by whatever Connection
  143. Tool is being invoked.  uupc simply passes these options through to the
  144. tool, and passes back any error information it receives in return.  It
  145. does not attempt to interpret these options itself.  Don't put more than
  146. 127 characters (excluding quotes but including quoted spaces) in either of
  147. these fields, or Bad Things will happen.
  148.  
  149. Listening for inbound calls
  150. ---------------------------
  151.  
  152. To receive incoming calls using a CTB tool, set up the configuration in
  153. the usual way.  In the Systems file line for the INCOMING pseudo-neighbor,
  154. specify "CTB/configurationname" in the device field, either "DIR" or "HAYES"
  155. in the dialer field, and specify "@" in the phone-number field.  You should,
  156. as always, specify the "HAYES" dialer only if you're using the Serial Tool...
  157. for other tools, specify "DIR", and let the tool itself listen for the
  158. inbound call.
  159.  
  160. Tool-supplied progress windows
  161. ------------------------------
  162.  
  163. Some connection tools, such as the Apple Modem Tool, will put up a non-modal
  164. dialog box when opening or closing a connection.  uupc 3.1 suppresses the
  165. appearance of these dialog boxes when it's run in the normal (no-debugging)
  166. mode.  The dialog boxes are enabled when debugging is turned on (level
  167. 1 or above).
  168.  
  169. Examples of use
  170. ---------------
  171.  
  172. In these examples, please assume that the following CTB configurations have
  173. been created and stored:
  174.  
  175.     modem - Serial Tool, accesses the modem port
  176.     work  - Apple Modem Tool, set up to dial my Sun at work
  177.  
  178. #
  179. # Call my system at work, using the Serial Driver and the HAYES dialer
  180. #
  181. ntg Any a HAYES+&B1&M0 9600 5551212 g7 ID? GHOTI ogin: IAM word: TRUSTME
  182. #
  183. # Call my system at work, using the Comm Toolbox to gain access to the
  184. # modem port, and use the built-in dialer
  185. #
  186. ntg Any CTB/modem HAYES+&B1&M0 9600 5551212 g7 ID? GHOTI ogin: IAM word: TRUSTME
  187. #
  188. # Call my system at work, using the Apple Modem Tool.  The phone number
  189. # and baud rate are already in the CTB configuration, and are not
  190. # respecified here.
  191. #
  192. ntg Any CTB/work DIR - - g7 ID? GHOTI ogin: IAM word: TRUSTME
  193. #
  194. # Call my system at work, using the Apple Modem Tool.  Override the phone
  195. # number in the CTB configuration.
  196. #
  197. ntg Any CTB/work DIR - 5551313 g7 ID? GHOTI ogin: IAM word: TRUSTME
  198. #
  199. # Call my system at work, using the Apple Modem Tool.  Override both the baud
  200. # rate and the phone number
  201. #
  202. ntg Any CTB/work DIR 2400 5551414 g7 ID? GHOTI ogin: IAM word: TRUSTME
  203. #
  204. # Listen for incoming calls using the Apple Modem Tool.  It doesn't matter
  205. # if there's a phone number in the configuration, as specifying "@" here
  206. # will cause it to be ignored, and an inbound-call listening operation to
  207. # take place.  If the caller requests the 'g' protocol, start negotiation
  208. # with a larger packet-size and window than is the default (this won't
  209. # affect the 'f' protocol if that's what the caller requests).
  210. #
  211. INCOMING Any CTB/work DIR - @ g7/128
  212.  
  213. Caveats
  214. -------
  215.  
  216. I've tested the incoming-call listener with the AppleTalk ADSP tool, over
  217. a Rube Goldberg sort of AppleTalk connection which involved a dialup
  218. Async AppleTalk connection, UDP, EtherTalk, a FastPath box, and LocalTalk
  219. to another Mac.  It actually worked, much to my amazement.  g3/64 sessions
  220. worked, with throughput limited to about 200 bytes/second over a V.32 link
  221. (too much latency).  g7/128 didn't work, apparently due to timing and
  222. error-recovery problems in the protocol that I haven't chased down yet.
  223. The 'f' protocol worked like a charm with excellent throughput - not
  224. surprising, as it's intended to work over long-distance networks.
  225.  
  226. I haven't yet run real-world tests on the incoming-call listener using
  227. the Apple Modem Tool - it should work, but I can't guarantee that it will.
  228.  
  229. I've had rather poor luck trying to use the Apple Modem Tool (version 1.1)
  230. with high-speed, speed-buffered modems (those in which the serial port
  231. speed is locked at a higher rate than the modem-to-modem modulation).
  232. The Apple Modem Tool has an annoying habit of "blasting" Hayes-style
  233. commands at the modem at full speed.  This seems to cause the command-
  234. autobauding logic in some modems to fail... not only does the modem fail
  235. to recognize the command, but it also goes into some severely confused
  236. state and won't recognize commands at _any_ speed until its power is turned
  237. off and then on again.  I deliberately introduced delays into the uupc
  238. HAYES dialer to keep this from happening;  there doesn't seem to be any
  239. way to persuade the Apple Modem Tool to insert similar delays.
  240.  
  241. So - use the Apple Modem Tool at your own risk of frustration.  At high
  242. line speeds, I find uupc's HAYES dialer to be more reliable.
  243.  
  244. The code has not yet been extensively beaten upon.  It may hang, crash,
  245. or defoliate your houseplants.  No guarantees.
  246.  
  247.